<!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta name="generator" content="Adobe RoboHelp - www.adobe.com">
<title>Adding data fields to a document</title>
<link rel="stylesheet" href="userhelp_ns.css"><script type="text/javascript" language="JavaScript" title="WebHelpSplitCss">
<!--
if (navigator.appName !="Netscape")
{   document.write("<link rel='stylesheet' href='userhelp.css'>");}
//-->
</script>
<style type="text/css">
<!--
p.whs1 { margin-left:0px; }
ul.whs2 { list-style:disc; }
ol.whs3 { list-style:decimal; }
ol.whs4 { list-style:lower-alpha; }
p.whs5 { margin-left:120px; }
ul.whs6 { list-style:square; }
-->
</style><script type="text/javascript" language="JavaScript">
<!--
if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))
{
  var strNSS = "<style type='text/css'>";
  strNSS += "p.whs1 {margin-left:1pt; }";
  strNSS +="</style>";
  document.write(strNSS);
}
//-->
</script>
<script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">
<!--
function reDo() {
  if (innerWidth != origWidth || innerHeight != origHeight)
     location.reload();
}
if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {
	origWidth = innerWidth;
	origHeight = innerHeight;
	onresize = reDo;
}
onerror = null; 
//-->
</script>
<style type="text/css">
<!--
div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }
-->
</style><script type="text/javascript" language="javascript1.2" src="whmsg.js"></script>
<script type="text/javascript" language="javascript" src="whver.js"></script>
<script type="text/javascript" language="javascript1.2" src="whproxy.js"></script>
<script type="text/javascript" language="javascript1.2" src="whutils.js"></script>
<script type="text/javascript" language="javascript1.2" src="whlang.js"></script>
<script type="text/javascript" language="javascript1.2" src="whtopic.js"></script>
</head>
<body><script type="text/javascript" language="javascript1.2">
<!--
if (window.gbWhTopic)
{
	if (window.addTocInfo)
	{
	addTocInfo("Creating and modifying documents and dashboards\nCreating and formatting a document\nAdding and editing text and data in a document\nAdding data fields to a document");
addButton("show",BTN_TEXT,"Show","","","","",0,0,"","","");

	}
	if (window.writeBtnStyle)
		writeBtnStyle();

	if (window.writeIntopicBar)
		writeIntopicBar(1);

	if(1)
	{
	
	}

	if (window.setRelStartPage)
	{
	setRelStartPage("MicroStrategy_Web_Help.htm");

		autoSync(1);
		sendSyncInfo();
		sendAveInfoOut();
	}
}
else
	if (window.gbIE4)
		document.location.reload();

//-->
</script>
<h1>Adding data fields to a document</h1>
<p>A data field is a reference to an object on a report. It is a type of 
 dynamic text. When you view the document as a PDF, the data fields are 
 replaced by the actual data. If the object referenced by a data field 
 is removed from the dataset report, the data field becomes static text 
 in the PDF.</p>
<p class="whs1">You can add data fields in any of the following 
 ways:</p>
<ul type="disc" class="whs2">
	
<li class=p><p class="whs1">Type static text to serve 
 as a label on the document. This procedure is below.</p></li>
	
<li class=p><p class="whs1">Drag and drop a dataset object 
 onto any section of the layout area. This creates a text field containing 
 a specially formatted string, which refers to the object on the dataset. 
 The string is the name of the object within braces { }. When the document 
 is executed, the string is replaced by the data it represents. This procedure 
 is below.</p></li>
	
<li class=p><p class="whs1">Type the data field manually. 
 This procedure is below.</p></li>
	
<li class=p><p class="whs1">Create a metric within the 
 document. For steps, see 
<a HREF="Creating_metrics_in_documents.htm">Creating 
 metrics in documents</a>.</p></li>
</ul>
<p class="whs1">For a detailed example of adding data fields 
 to a document, with images, see the <span style="font-style: italic;"><I>MicroStrategy 
 Report Services Document Creation Guide</I></span>.</p>
<h2>
<a name="Add data field procedure"></a>To add a data field</h2>
<ol type="1" class="whs3">
	
<li class=p><p>Open the document and, from the <span style="font-weight: bold;"><B>Home</B></span> 
 menu, select <span style="font-weight: bold;"><B>Design Mode</B></span> or <span 
 style="font-weight: bold;"><B>Editable Mode</B></span>. </p></li>
	
<li class=p><p>Use one of the following methods: </p></li>
	<ul>
<li style="list-style: disc;" type=disc class=p><p><span style="font-weight: bold;"><B>Type 
 static text to serve as a label</B></span>:</p></li>
		<ol>
<li style="list-style: lower-alpha;" type=a class=p><p>From 
 the <span style="font-weight: bold;"><B>Insert</B></span> menu, select <span 
 style="font-weight: bold;"><B>Text</B></span>. A blank text field is inserted.</p></li>
			
<li style="list-style: lower-alpha;" type=a class=p><p>Type 
 the static text.</p></li>
			
<li style="list-style: lower-alpha;" type=a class=p><p>Press 
 <span style="font-weight: bold;"><B>Enter</B></span> when you are finished.</p></li>
		</ol>
		
<li style="list-style: disc;" type=disc class=p><p><span style="font-weight: bold;"><B>Drag 
 and drop a dataset object</B></span>:</p></li>
		<ol type="a" class="whs4">
			
<li class=p><p>From the objects displayed in Dataset Objects, 
 select the object you want to use.</p></li>
			
<li class=p><p>Drag and drop the selected object into the Layout 
 area.</p></li>
		</ol>
	</ul>
</ol>
<p class="whs5"><span style="font-weight: bold;"><B>Notes</B></span>: 
 </p>
<ul type="square" class="whs6">
	
<li style="margin-left: -20px;" class=p><p class="whs5">To 
 ensure that data fields are resolved correctly when the PDF is displayed 
 in a language other than English, each text field is automatically placed 
 within square brackets [ ] when you drop it in the layout area. After 
 you save and re-open the document, the brackets remain only if the object 
 name contains special characters. A special character is any character 
 other than a to z, A to Z, 0 to 9, #, _, and . (period). </p></li>
	
<li style="margin-left: -20px;" class=p><p class="whs5">When 
 you add a metric to the document, the dataset name is added to the string 
 if the metric exists in multiple datasets.</p></li>
	<ul type="disc" class="whs2">
		
<li class=p><p class="whs1"><span style="font-weight: bold;"><B>Type 
 the data field manually</B></span>:</p></li>
		<ol>
<li style="list-style: lower-alpha;" type=a class=p><p>From 
 the <span style="font-weight: bold;"><B>Insert</B></span> menu, select <span 
 style="font-weight: bold;"><B>Text</B></span>. A blank text field is inserted.</p></li>
			
<li style="list-style: lower-alpha;" type=a class=p><p>Type 
 the object's name within braces, such as <span class=Code>{Revenue}</span> 
 or <span class=Code>{Region}</span>. The name must match either the name 
 of an object in a dataset or its alias. If either name contains spaces 
 or special characters, you must type it in square brackets [ ] &nbsp;within 
 the braces, as in <span class=Code>{[Last Year Revenue]}</span>. A special 
 character is any character other than a – z, A – Z, 0 – 9, #, _, and . 
 (period). </p></li>
			
<li style="list-style: lower-alpha;" type=a class=p><p>To display 
 a particular attribute form, type <span class=Code>@</span><span class=Code 
 style="font-style: italic;"><I>attribute_form</I></span> after 
 the object name, within the braces, where <span class=Code style="font-style: italic;"><I>attribute_form</I></span> 
 is the name of the attribute form to be displayed. If you specify an attribute 
 form that does not exist for an attribute, the data field cannot be resolved 
 and the syntax is displayed as text in the PDF.</p></li>
			
<li style="list-style: lower-alpha;" type=a class=p><p>If the 
 same object name is used in multiple datasets, use the syntax <span class=Code>{[</span><span 
 class=Code style="font-style: italic;"><I>dataset name</I></span><span class=Code>]}:{[</span><span 
 class=Code style="font-style: italic;"><I>object name</I></span><span class=Code>]}</span>.</p></li>
			
<li style="list-style: lower-alpha;" type=a class=p><p>To resize 
 the text field, click and drag in the section.</p></li>
			
<li style="list-style: lower-alpha;" type=a class=p><p>Press 
 <span style="font-weight: bold;"><B>Enter</B></span> when you are finished.</p></li>
		</ol>
	</ul>
</ul>
<ol start="3" type="1" class="whs3">
	
<li class=p><p>The text field is automatically formatted in a default 
 style using the 
<a HREF="Control_defaults.htm">defaults for that control</a>. 
 To change the formatting of the text field, right-click the text field 
 and select <span style="font-weight: bold;"><B>Properties and Formatting</B></span>. 
 You can format general and layout properties for the text field, such 
 as name, position, and size, as well as font, alignment, number format, 
 border, and color options, including gradient colors, 3D borders, and 
 drop shadows.</p></li>
</ol>
<p>To move the data field to a different area of the document, see 
<a href="Move_controls_on_documents.htm">Moving 
 controls on documents</a>.</p>
<script type="text/javascript" language="javascript1.2">
<!--
highlightSearch();
if (window.writeIntopicBar)
	writeIntopicBar(0);
if(0)
{

}
//-->
</script>
</body>
</html>
